home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / dmpcc16.zip / DMPCC16.DOC < prev    next >
Text File  |  1994-01-11  |  13KB  |  264 lines
  1.  
  2.                                      01-11-94
  3.                      DMP Control Center v1.6 Documentation           
  4.                      -------------------------------------
  5.  
  6. I'll try to make this short and simple.
  7.  
  8. I made this program because I love the Dual Module Player (DMP) written by
  9. Otto Chrons and the Protected Module Player(PMP) written by Jussi Lahdenniemi
  10. and Otto Chrons.  In my opinion, they are the best .MOD players in existence.
  11. They also play .669, .S3M, .AMF, .STM, .NST, and .MTM files, as well as some
  12. other music formats.  They support practically every sound card and have
  13. incredible sound quality.  The only main difference between the two is that
  14. PMP uses XMS while DMP uses EMS.  Anyway, these programs are lacking in only
  15. one item:  there is no shell where you can select files.  I have seen a couple
  16. of other DMP shell programs, and I didn't like them, so I made my own.
  17.  
  18.  
  19. I.  Command-line options:
  20. -------------------------
  21.  
  22. dmpcc </NE> </?> <directory to begin in>
  23.  
  24. No options are necessary.  Don't type the < and the >.
  25.  
  26. /NE stands for NO EMS.  Otherwise the program will attempt to use EMS for
  27. the overlay file if it is available.
  28.  
  29. /? gives a very small help screen
  30.  
  31.  
  32. II.  In-program options:
  33. ------------------------
  34.  
  35. H = help
  36. P or ENTER = play current file
  37. D = delete current file or remove highlighted subdirectory if it is empty
  38. R = rename current file
  39. C = copy current file
  40. M = move current file
  41. L = log onto new drive
  42. F = change filespec mask
  43. ENTER = change directory (if highlight bar is on a directory)
  44. TAB = toggle between INTERNAL and EXTERNAL decompression
  45. SPACE = tag or untag current file and advance highlight bar
  46. ALT-T = tag or untag all files
  47. ALT-D = delete all tagged files
  48. ALT-C = copy all tagged files
  49. ALT-M = move all tagged files
  50. ALT-P = play all tagged files normally (sends a listfile to the player)
  51. CONTROL-P = play all tagged files in 1 x 1 mode
  52.    *********
  53.      note:  I put this option in because occasionally, DMP and PMP will have
  54.             problems if there are a lot of files in memory.  1 x 1 mode will
  55.             play a file, wait a moment and give you a chance to abort by 
  56.             hitting ESC, and then move onto the next file, eliminating any
  57.             memory problems.
  58.    *********
  59. ALT-X = quit DMP Control Center
  60. FUNCTION KEYS F1 - F9 = choose 1 of the 9 possible configurations you
  61.                         have chosen in the DMPCC.CFG configuration file
  62.  
  63.  
  64.  
  65. III.  Configuration File:
  66. -------------------------
  67.  
  68. The file dmpcc.cfg MUST exist in the same directory as the dmpcc.exe file,
  69. and it must contain at least one useable player configuration line.  'Player
  70. configuration' means all the information needed to run an external program,
  71. such as DMP or PMP.  You can have up to 9 player configurations in this file.
  72. Lines starting with ; or { or a space will be ignored.  On each player config-
  73. uration line, put an executable file followed by it's command-line parameters.
  74. have provided examples of player configurations in the configuration  file
  75. already.  Here is an example of 2 player configuration lines:
  76.  
  77. c:\pas16\dmp\dmp.exe -c4 -i5 -d5 -s44100
  78. c:\pas16\pmp\pmp.exe -c4 -i5 -d5
  79.  
  80.  
  81. If you wish, you can specify the default filespec mask for DMP Control Center
  82. in the configuration file as well.  If no values for this are entered in the
  83. configuration file, DMP Control Center will start out with the mask *.*.
  84. Capitalization does not matter.  Examples:
  85.  
  86. default_file_mask=*.mod
  87. default_file_mask=song.*
  88. default_file_mask=*.*
  89.  
  90.  
  91. You can also specify in the config file the default directory for DMP Control
  92. Center to start in.  This can be bypassed by providing a directory in the
  93. command line.  Capitalization does not matter.  Example:
  94.  
  95. default_directory=c:\pas16\mod
  96.  
  97.  
  98. If you want to be able to play archived modules, unless you will only be
  99. using EXTERNAL decompression, you must specify the locations of your archive
  100. program(s) in the configuration file.  With external decompression, as
  101. explained below, the program being called, such as DMP, will take care of all
  102. of the decompressing of archived files.  For each archive program you want to
  103. use, you must include the entire path and the executable file for that
  104. program.  You can also specify the drive on which DMP Control Center will make
  105. a temporary directory to uncompress files into.  If no drive is specified,
  106. then the drive where DMP Control Center first starts playing from will be
  107. used, specified either in the DEFAULT_DIRECTORY line of the configuration file
  108. or in the command-line.  This directory will be made and removed each time the
  109. user plays an archived file or files.  Capitalization does not matter.
  110. Example:
  111.  
  112. zip=c:\util\pkzip\pkunzip.exe
  113. arj=c:\util\arj\arj.exe
  114. lha=c:\util\lha\lha.exe
  115. temp=d:
  116.  
  117. You only have to include lines for those archive programs which you will be
  118. using.  Only PKZIP, ARJ, and LHA compression techniques are supported.
  119. To specify how DMP Control Center will manage decompression of archive files
  120. when it first starts, add one of the following lines:
  121.  
  122. internal_decompression=false
  123. internal_decompression=true
  124.  
  125. 'True' specifies INTERNAL decompression, meaning that DMP Control Center will
  126. deompress files with the archive information you included in the configuration
  127. file, while 'false' specifies EXTERNAL decompression, meaning that when the
  128. user tries to play an archived file, DMP Control Center will not handle the
  129. decompression at all, leaving the entire responsibility up to the external
  130. player program, such as DMP.  You can change this value with the TAB key while
  131. in DMP Control Center.
  132.  
  133.  
  134.  
  135.  
  136. IV.  Archive Support:
  137. ---------------------
  138.  
  139. DMP Control Center will play files which have been compressed with PKZIP, ARJ,
  140. and LHA.  All files in an archive file which match the pre-extension part of
  141. the archive filename will be played.  So if you try to play the file SONG.ZIP,
  142. all files inside SONG.ZIP which match the mask SONG.* will be played.  DMP
  143. Control Center will make a temporary directory on the drive which the user has
  144. selected in the configuration file.  If no drive is selected, the startup
  145. drive will be used.  This is where files will be extracted to in order to be
  146. played.  If there is insufficient room on that drive, then only the files
  147. which were able to be extracted will be played.  After they are played, the
  148. extracted files will be deleted and the temporary directory will be removed.
  149. You must include the location of any archive programs you wish to use in the
  150. dmpcc.cfg file.  This is explained in detail in the above section,
  151. "Configuration File."   A final note - because most module players, such as
  152. PMP, cannot handle archived files on their own, DMP Control Center will NOT
  153. play archived files with the ALT-P mode.  This is because when you hit ALT-P,
  154. a listfile is sent to the player program and if the listfile contains archived
  155. files, the player will probably crash if it does not have archive capabilit-
  156. ies.  CONTROL-P and P will still work all the time.  If you hit ALT-P and some
  157. of the tagged files have extensions which DMP Control Center recognize as
  158. belonging to archived files, no files will be played and an error message will
  159. appear on the screen.  However, right after I added archive suppport to DMP
  160. Control Center, it was added to DMP v2.76 too.  So I decided to let the user
  161. be in control of which program handles the uncompressing - DMP(EXTERNAL
  162. DECOMPRESSION) or DMP Control Center(INTERNAL DECOMPRESSION).  You can use the
  163. TAB key to switch between the two while in DMP Control Center, and you can
  164. specify which one you want at startup with the configuration file.  If you are
  165. using external decompression, meaning that the player which DMP Control Center
  166. is calling is taking care of the decompression, then you are able to use ALT-P
  167. to play multiple archived files.  If, for some reason, you are using a player
  168. other than DMP to play your modules, such as PMP, and some of the files which
  169. you will be playing are archived, you will want to use INTERNAL decompression,
  170. since PMP cannot, as of this writing, handle decompression on its own. 
  171.  
  172.  
  173. V.  Other Notes:
  174. ----------------
  175.  
  176. You do not have to be in the directory of dmpcc.exe to run the program. The
  177. maximum number of files that DMP Control Center can read in one directory is
  178. 1400.  Any files beyond this amount will be ignored.  This shouldn't be too
  179. much of a problem.  DO NOT try to use compress DMPCC.EXE with a program like
  180. PKLITE, because it will destroy the overlay.  (PKLITE will not let you
  181. compress it, but other run-time compression programs will.)  I have already
  182. compressed it with PKLITE before adding the overlay file anyway.
  183.  
  184.  
  185. VI.  Bugs:
  186. ----------
  187.  
  188. The only bug I am aware of is that if a directory is hidden or read-only,
  189. DMP Control Center will read it as a normal file.  I tried to get this to
  190. work right, but I haven't figured it out yet.  If you can help me on this,
  191. please leave me email at my Internet address(below).  Thanks.
  192.  
  193.  
  194.  
  195.  
  196. VII.  Where I Can Be Reached:
  197. -----------------------------
  198.  
  199. PLEASE report ANY bugs, problems, suggestions, compliments, etc... to my 
  200. Internet email address:  klenk@cs.odu.edu
  201.  
  202. This program is free, but of course I'll take all your money if you want...
  203.  
  204.  
  205.  
  206. Revisions:
  207. ----------
  208.  
  209. v1.6  01-11-94 : Fixed a bug with moving multiple read-only files when the
  210.          files were overwriting other read-only files.  Reduced the
  211.          size of the .EXE file by almost 10k.  More minor bugs fixed.
  212.                  I also slightly optimized the code, allowing me to raise the
  213.                  number of files which can be read in each directory back up
  214.                  to 1400.
  215.  
  216. v1.5  12-07-93 : Well, right after I added archive support to DMPCC, Otto
  217.                  Chrons added it to DMP v2.76.  So, I figured that I should
  218.                  give the user the option of whether to use the decompression
  219.                  programs defined in the dmpcc.cfg file OR to let DMP take
  220.                  care of the decompression.  The only reason to put DMP
  221.                  Control Center in charge of decompression(internal
  222.                  decompression) as opposed to DMP(external decompression) is
  223.                  if you are using a player such as PMP which cannot handle
  224.                  archived files on its own.  If you choose external
  225.                  decompression, you can use ALT-P to play multiple archived
  226.                  files.
  227.  
  228. v1.4  12-04-93 : MANY improvements.  Interface redesigned, MUCH faster.  Sorry
  229.              that it was slow before, but I have a 486-50 and didn't
  230.              even notice.  A few bugs in the scroll routine are now fixed.
  231.          Also fixed - a bug in which if you tried to remove an empty
  232.          directory which was the current directory on that drive, the
  233.          directory didn't get removed.  And yet another bug:  If the
  234.          default directory had more than 12 characters, only the first
  235.          12 would be used.  Fixed.  And the major improvement to this
  236.          version is archive support.  (Only PKZIP, ARJ, and LHA).
  237.          Read about how to play archived modules in the doc file.
  238.          The overlay file (dmpcc.ovr) is no longer needed.  It is now
  239.          stored in the .EXE file, extracted at run-time, then deleted.
  240.          The ENTER key can now be used just like P to play one file.
  241.          The only drawback to this version is that I have reduced the
  242.          number of files which can be read in one directory to 1200,
  243.          down from 1400.  This is due to memory being reduced by the
  244.          other features which I have improved and added.  I'll try to
  245.          fix this in the future.
  246.  
  247. v1.3  10-07-93 : Fixed a small bug with the scroll routine.  Fixed a very
  248.          obscure bug in the procedure which reads the command-line
  249.          parameters, which would occur if 2 or more \ characters were
  250.          placed together.  Sped up the screen-draw routines.
  251.  
  252. v1.2  09-22-93 : I received a suggestion to increase the maximum number of
  253.          files that DMPCC can handle.  It used to be 450.  It is now
  254.          1400.  This should really be enough for anyone.  If you have
  255.          more than 1400 mods, let me know.  Now you can use a semi-
  256.          colon (;) as a 'remark' indicator in the config file as well
  257.          as a { or a space.  Fixed a bug with trying to copy or move a
  258.          file to a drive that had insufficient space.
  259.  
  260. v1.1  09-20-93 : Fixed a bug in the move and copy procedures, where if the
  261.          user tried to copy or move a file(s) to the same directory,
  262.          the file would be reduced to 0 bytes.
  263.  
  264. v1.0  09-14-93 : First public release.